風險代幣列表
介面描述
取得AI透過多維度資料，追蹤到當前行情下具有下跌風險趨勢的代幣列表。
使用情境：
- 適用於當前行情下存在下跌行情風險的代幣查詢
- 適用於風險預警和持倉規避参考
資料更新頻率：每5分鐘更新一次
請求 URL
- 方法：
POST - 路徑：
/open/v1/ai/getRiskCoinList
點數消耗
- 消耗點數：
6
前置條件
無前置條件，可直接呼叫。
請求參數
參數透過請求體（Body）以 JSON 格式傳遞。
無請求參數。
回應欄位
僅展示 data 陣列內每個物件的欄位結構：
| 欄位 | 類型 | 實際回傳類型 | 描述 |
|---|---|---|---|
| vsTokenId | long | string | 代幣 ID |
| symbol | string | string | 幣種符號 |
| price | number | string | 當前價格 (USD) |
| maxPrice | number | string | 歷史最高價格 (USD) |
| minPrice | number | string | 歷史最低價格 (USD) |
| percentChange1h | number | string | 1 小時價格變化百分比 |
| percentChange24h | number | string | 24 小時價格變化百分比 |
| percentChange7d | number | string | 7 天價格變化百分比 |
| percentChange30d | number | string | 30 天價格變化百分比 |
| percentChange60d | number | string | 60 天價格變化百分比 |
| percentChange90d | number | string | 90 天價格變化百分比 |
| cost | number | string | 主力成本價格 (USD) |
| costChange | number | string | 成本變化率 |
| deviation | number | string | 價格偏离度 (%) |
| marketCap | number | string | 市值 (USD) |
| marketCapRanking | integer | integer | 市值排名 |
| circulatingSupply | number | string | 流通供應量 |
| circulationRate | number | string | 流通率 (%) |
| active | integer | string | 24h 活跃位址數 |
| newly | integer | string | 24h 新增位址數 |
| tradeType | integer | integer | 交易類型（1:現貨 2:合約 3:交割合約） |
| chanceCoinTradeDataV1Vos | array | array | 交易時間資料列表 |
| timeRange | string | string | 時間範圍識別（如 m15, H4） |
| timeParticleEnum | integer | integer | 時間粒度列舉值 |
| tradeInflow | number | string | 交易淨流入金額 (USD) |
| tradeAmount | number | string | 交易總金額 (USD) |
| updateTime | long | long | 更新時間（毫秒時間戳） |
| pushPrice | number | string | 風險推送價格 (USD) |
| pushMaxPrice | number | string | 推送後最高價 (USD) |
| gains | number | number | 推送後漲幅 (%) |
| pushMinPrice | number | string | 推送後最低價 (USD) |
| declines | number | number | 推送後跌幅 (%) |
| score | number | number | AI 風險評分 |
| bullishRatio | number | number | 看漲情緒比例 |
| bearishRatio | number | number | 看跌情緒比例 |
欄位業務含義
以下欄位需要特別說明其業務含義：
| 欄位 | 業務含義 | 範圍/計算方式 | 使用建議 |
|---|---|---|---|
| cost | 主力成本價格 | 依大額交易加權計算的主力持倉成本 | 當前價格高於成本價時主力可能獲利了結 |
| deviation | 價格偏离度 | (当前价格 - 主力成本) / 主力成本 * 100% | 正值過大時需警惕回調風險 |
| score | AI 風險評分 | 範圍 0-100，基於資金流、技術指標等綜合計算 | 評分 < =45或評分>=80:待观察代幣; 45 < 評分 < 75:观察代幣; 75 < 評分 < 80：下跌風險代幣 |
| pushPrice | 風險推送價格 | 系統首次推送該風險代幣時的價格 | 用於計算推送後的漲跌幅 |
| declines | 推送後跌幅 | (pushPrice - pushMinPrice) / pushPrice * 100% | 驗證風險預警的準確性 |
| tradeInflow | 交易淨流入 | 正值為資金流入，負值為資金流出 | 持續負值表示主力在出貨 |
列舉值說明
tradeType - 交易類型
| 值 | 含义 |
|---|---|
| 1 | 現貨 |
| 2 | 合約（永續） |
| 3 | 交割合約 |
timeParticleEnum - 時間粒度
| 值 | 含义 |
|---|---|
| 5 | 5 分鐘 |
| 15 | 15 分鐘 |
| 30 | 30 分鐘 |
| 101 | 1 小時 |
| 104 | 4 小時 |
| 106 | 6 小時 |
| 124 | 24 小時 |
| 201 | 1 天 |
| 202 | 2 天 |
| 207 | 7 天 |
| 230 | 30 天 |
請求範例
json
{}cURL 範例（Linux/macOS）
bash
curl --location --request POST 'http://${host}/api/open/v1/ai/getRiskCoinList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{}'cURL 範例（Windows CMD）
cmd
curl --location --request POST "http://${host}/api/open/v1/ai/getRiskCoinList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{}"成功回應範例
json
{
"code": 200,
"message": "success",
"data": [
{
"vsTokenId": "38178", // 代币 ID
"symbol": "TRUTH", // 币种符号
"price": "0.009401", // 当前价格
"maxPrice": "0.0501747614230509", // 最高价格
"minPrice": "0.008377211395908427", // 最低价格
"percentChange1h": "-0.416791", // 1 小时价格变化百分比
"percentChange24h": "-0.22235364", // 24 小时价格变化百分比
"percentChange7d": "-0.64120527", // 7 天价格变化百分比
"percentChange30d": "-33.88558117", // 30 天价格变化百分比
"percentChange60d": "-36.70969242", // 60 天价格变化百分比
"percentChange90d": "-52.50016328", // 90 天价格变化百分比
"cost": "", // 成本价格
"costChange": "", // 成本变化
"deviation": "", // 偏离度
"marketCap": "19433307.396503072", // 市值
"marketCapRanking": 427, // 市值排名
"circulatingSupply": "2085305300", // 流通供应量
"circulationRate": "20.853053", // 流通率
"active": "", // 活跃地址
"newly": "", // 新增地址
"tradeType": 2, // 交易类型（1:现货 2:合约 3:交割合约）
"chanceCoinTradeDataV1Vos": [], // 交易时间数据列表
"updateTime": 1771287000000, // 更新时间
"pushPrice": "0.01565", // 推送价格
"pushMaxPrice": "0.016266", // 推送最高价
"gains": 0.0, // 回撤
"pushMinPrice": "0.0088", // 推送最低价
"declines": 43.769968, // 跌幅
"score": 36.5, // 当前评分
"bullishRatio": "", // 看涨比例
"bearishRatio": "" // 看跌比例
},
{
"vsTokenId": "36341",
"symbol": "ASTER",
"price": "0.714",
"maxPrice": "2.419058923870731",
"minPrice": "0.08438718204444161",
"percentChange1h": "0.10564628",
"percentChange24h": "1.13663783",
"percentChange7d": "1.64029621",
"percentChange30d": "9.69143917",
"percentChange60d": "1.73287042",
"percentChange90d": "-25.22011773",
"cost": "1.172355914203435426",
"costChange": "0.881647",
"deviation": "67.240501",
"marketCap": "1767827178.5568295",
"marketCapRanking": 32,
"circulatingSupply": "2476688843.7843533",
"circulationRate": "30.958611",
"active": "7920",
"newly": "7920",
"tradeType": 2,
"chanceCoinTradeDataV1Vos": [
{
"timeRange": "m30", // 时间范围
"timeParticleEnum": 30, // 时间范围枚举值
"tradeInflow": "-69560.54264", // 交易净流入金额
"tradeAmount": "350999.52609999996" // 交易金额
},
{
"timeRange": "D2",
"timeParticleEnum": 202,
"tradeInflow": "-713799.0313099995",
"tradeAmount": "30846831.661049996"
},
{
"timeRange": "H6",
"timeParticleEnum": 106,
"tradeInflow": "-387193.49147999985",
"tradeAmount": "4142104.91086"
}
// ... 更多数据省略
],
"updateTime": 1772796000000,
"pushPrice": "0.702",
"pushMaxPrice": "0.721",
"gains": 0.0,
"pushMinPrice": "0.673",
"declines": 4.131054,
"score": 78.0,
"bullishRatio": 0.5,
"bearishRatio": 0.25
},
{
"vsTokenId": "36532",
"symbol": "B",
"price": "0.1778",
"maxPrice": "0.7315687936140746",
"minPrice": "0.001494456258922425",
"percentChange1h": "0.44653729",
"percentChange24h": "-0.00641715",
"percentChange7d": "-20.99954538",
"percentChange30d": "15.74594892",
"percentChange60d": "-34.99023983",
"percentChange90d": "-27.74099941",
"cost": "0.33326457023010802",
"costChange": "0",
"deviation": "83.819399",
"marketCap": "176827300.56855285",
"marketCapRanking": 125,
"circulatingSupply": "1000000000",
"circulationRate": "100",
"active": "154",
"newly": "154",
"tradeType": 2,
"chanceCoinTradeDataV1Vos": [],
"updateTime": 1773008700000,
"pushPrice": "0.2069",
"pushMaxPrice": "0.216",
"gains": 0.0,
"pushMinPrice": "0.1706",
"declines": 17.544708,
"score": 41.0,
"bullishRatio": 0.4286,
"bearishRatio": 0.0
}
// ... 更多数据省略
],
"requestId": "xxx-xxx-xxx"
}